Inside Macintosh: QuickDraw GX Printing Extensions and Drivers /

Chapter 4 - Printing Messages / Printing Messages Reference

Printing Messages / Compatibility Messages

GXPrJobMerge

QuickDraw GX sends the GXPrJobMerge message when an application that supports the Macintosh Printing Manager calls the PrJobMerge function. You can override the GXPrJobMerge message to customize the handling of the PrJobMerge function. Your override of the GXPrJobMerge message must match the following formal declaration:

OSErr MyPrJobMerge (THPrint aTHPrint1, THPrint aTHPrint2);

aTHPrint1

A handle to the first print record for this printing operation.

aTHPrint2

A handle to the second print record for this printing operation.

function result

An error code. The value noErr indicates that the operation was successful.

DESCRIPTION

The default implementation of this message merges the two print records and calls GXConvertPrintRecordTo to add the print information to the job collection so that you can print several documents with a single dialog box. You can override this message if you need to add any special handling to the processing of GXPrJobMerge calls for your driver.

SPECIAL CONSIDERATIONS

You never send the GXPrJobMerge message yourself.

You almost always forward the GXPrJobMerge message so that the default implementation can perform its operations.

RESULT CODES

gxSegmentLoadFailedErr	A required code segment could not be found, or there was not enough memory to load it.
gxPrUserAbortErr	The user has canceled printing.

SEE ALSO

The PrJobMerge function is described in Inside Macintosh: Imaging With QuickDraw.

The GXConvertPrintRecordTo function is described in Inside Macintosh: QuickDraw GX Printing.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help